home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / relnotes / pcp / ch2.z / ch2
Encoding:
Text File  |  1997-04-07  |  30.0 KB  |  821 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product- and release-specific; use it with the Installation
  13.        Guide to install this product.
  14.  
  15.        Additional information concerning PCP installation and
  16.        post-installation customization may be found in the Insight
  17.        book _P_e_r_f_o_r_m_a_n_c_e _C_o-_P_i_l_o_t _U_s_e_r'_s _a_n_d _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e
  18.        that is distributed with the images.
  19.  
  20.        2.1  _P_e_r_f_o_r_m_a_n_c_e__C_o_-_P_i_l_o_t__S_u_b_s_y_s_t_e_m_s
  21.  
  22.        The Performance Co-Pilot product includes these subsystems:
  23.  
  24.        _p_c_p._b_o_o_k_s._P_C_P__P_G
  25.                    The _P_e_r_f_o_r_m_a_n_c_e _C_o-_P_i_l_o_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e, an
  26.                    Insight book.
  27.  
  28.        _p_c_p._b_o_o_k_s._P_C_P__U_A_G
  29.                    The _P_e_r_f_o_r_m_a_n_c_e _C_o-_P_i_l_o_t _U_s_e_r_s'_s _a_n_d
  30.                    _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e, an Insight book.
  31.  
  32.        _p_c_p._b_o_o_k_s._h_e_l_p
  33.                    ``Help'' cards for PCP monitor applications
  34.                    integrated into the SGIHelp framework.
  35.  
  36.        _p_c_p._m_a_n._p_a_g_e_s
  37.                    Manual pages for the binaries and libraries.
  38.  
  39.        _p_c_p._m_a_n._r_e_l_n_o_t_e_s
  40.                    These release notes.
  41.  
  42.        _p_c_p._m_a_n._t_u_t_o_r_i_a_l
  43.                    An interactive Showcase tutorial that highlights
  44.                    the features and services of PCP.
  45.  
  46.        _p_c_p._s_w._c_i_s_c_o
  47.                    The optional cccciiiissssccccoooo PMDA collects performance
  48.                    metrics characterizing traffic through one or
  49.                    more Cisco routers.
  50.  
  51.                    This subsystem must be installed on each
  52.                    collector configuration from which Cisco metrics
  53.                    are to be exported, and each monitor
  54.                    configuration on which the Cisco metrics are to
  55.                    be displayed.
  56.  
  57.        _p_c_p._s_w._c_o_l_l_e_c_t_o_r
  58.                    The components for a PCP collector
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.                    configuration, including ppppmmmmccccdddd(1) and all of the
  75.                    default Performance Metrics Domain Agents
  76.                    (PMDAs).
  77.  
  78.                    For a PCP monitor-only configuration,
  79.                    installation of this subsystem is not required.
  80.  
  81.        _p_c_p._s_w._d_e_m_o
  82.                    Source code and annotated examples for some PCP
  83.                    tools, some sample programs and optional
  84.                    demonstration PMDAs.  The latter provide a basis
  85.                    for the development of new PMDAs to incorporate
  86.                    additional performance metrics from site-
  87.                    specific and application-specific domains into
  88.                    the PCP framework.  The sample programs provide
  89.                    a basis for the development of new clients to
  90.                    provide either generic, or site-specific and/or
  91.                    application-specific processing and analysis of
  92.                    performance metrics delivered via the PCP
  93.                    framework.
  94.  
  95.        _p_c_p._s_w._e_n_v_i_r_o_n
  96.                    The optional eeeennnnvvvviiiirrrroooonnnn PMDA collects performance
  97.                    metrics from the environmental monitor on a
  98.                    Challenge or Onyx system.
  99.  
  100.                    This subsystem must be installed on each
  101.                    collector configuration from which environ
  102.                    metrics are to be exported, and each monitor
  103.                    configuration on which the environ metrics are
  104.                    to be displayed.
  105.  
  106.        _p_c_p._s_w._e_o_e
  107.                    Executable programs, libraries, scripts and
  108.                    configuration files that are required for every
  109.                    PCP deployment.  Also, the header files required
  110.                    to compile C (or C++) programs that use the
  111.                    Performance Metrics API (PMAPI) supported by the
  112.                    Performance Co-Pilot.
  113.  
  114.                    You need to install this subsystem if you wish
  115.                    to use the Performance Co-Pilot in either
  116.                    monitor or collector configurations, or if you
  117.                    wish to develop new programs using the PMAPI, or
  118.                    compile any of the demonstration programs that
  119.                    use the PMAPI.
  120.  
  121.        _p_c_p._s_w._m_o_n_i_t_o_r
  122.                    The components for a PCP monitor configuration,
  123.                    including all of the tools for display,
  124.                    visualization and automated reasoning about
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.                    performance data.
  141.  
  142.                    For a PCP collector-only configuration,
  143.                    installation of this subsystem is not required.
  144.  
  145.        _p_c_p._s_w._s_h_p_i_n_g
  146.                    The optional sssshhhhppppiiiinnnngggg PMDA may be configured to
  147.                    probe quality of service for any command that
  148.                    can be run from the shell, sssshhhh(1).  Common uses
  149.                    are for monitoring DNS, rpcinfo, SMTP, yp and
  150.                    nntp services, and interactive shell response
  151.                    time.
  152.  
  153.        _p_c_p._s_w._s_u_m_m_a_r_y
  154.                    The optional ssssuuuummmmmmmmaaaarrrryyyy PMDA may be configured to
  155.                    export performance metrics computed from other
  156.                    performance metrics on one or more hosts.
  157.  
  158.                    This subsystem must be installed on each
  159.                    collector configuration from which summary
  160.                    metrics are to be exported, and each monitor
  161.                    configuration on which the summary metrics are
  162.                    to be displayed.
  163.  
  164.  
  165.        2.2  _P_e_r_f_o_r_m_a_n_c_e__C_o_-_P_i_l_o_t__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  166.  
  167.        This section lists the PCP subsystems (and their sizes).
  168.  
  169.        If you are installing this product for the first time, the
  170.        subsystems marked ``default'' are the ones that are
  171.        installed if you use the ``go'' menu item.  To install a
  172.        different set of subsystems, use the ``install,''
  173.        ``remove,'' ``keep,'' and ``step'' commands in iiiinnnnsssstttt to
  174.        customize the list of subsystems to be installed, then
  175.        select the ``go'' menu item.
  176.  
  177.        Note:  The listed subsystem sizes are approximate. Refer to
  178.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  179.               on finding exact sizes.
  180.  
  181.        Subsystem Name                Subsystem Size
  182.                                      (Kbytes)
  183.        _p_c_p._b_o_o_k_s._P_C_P__P_G                   1000
  184.        _p_c_p._b_o_o_k_s._P_C_P__U_A_G                  2000
  185.        _p_c_p._b_o_o_k_s._h_e_l_p                     1000
  186.        _p_c_p._m_a_n._p_a_g_e_s (default)             600
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                   - 4 -
  201.  
  202.  
  203.  
  204.        _p_c_p._m_a_n._r_e_l_n_o_t_e_s (default)           50
  205.        _p_c_p._m_a_n._t_u_t_o_r_i_a_l                   5000
  206.        _p_c_p._s_w._c_i_s_c_o                        100
  207.        _p_c_p._s_w._c_o_l_l_e_c_t_o_r (default)         1500
  208.        _p_c_p._s_w._d_e_m_o                         150
  209.        _p_c_p._s_w._e_n_v_i_r_o_n                       10
  210.        _p_c_p._s_w._e_o_e (default)               2800
  211.        _p_c_p._s_w._m_o_n_i_t_o_r (default)           3500
  212.        _p_c_p._s_w._s_h_p_i_n_g                        40
  213.        _p_c_p._s_w._s_u_m_m_a_r_y                       40
  214.  
  215.  
  216.  
  217.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  218.  
  219.        All of the subsystems for Performance Co-Pilot can be
  220.        installed using IRIX.  You do not need to use the miniroot.
  221.        Refer to the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete
  222.        installation instructions.
  223.  
  224.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  225.  
  226.        Due to packaging and file location changes, there are some
  227.        versions of PCP add-on products that are incompatible with
  228.        PCP 1.3 and should be removed before PCP 1.3 is installed.
  229.        Once PCP 1.3 has been installed, the new versions of the
  230.        corresponding add-on products should be re-installed with
  231.        iiiinnnnsssstttt.
  232.  
  233.           _____________________________________________________
  234.            PCP Add-on   Version to Remove   Version to Install
  235.             Product      Before PCP 1.3       After PCP 1.3
  236.           _____________________________________________________
  237.            PCPWEB              1.0                 1.1
  238.           _____________________________________________________
  239.           ||||
  240.  
  241.  
  242.                       ||||
  243.  
  244.  
  245.                                           ||||
  246.  
  247.  
  248.                                                                ||||
  249.  
  250.  
  251.  
  252.  
  253.        For example,
  254.            # versions remove pcp_web
  255.            # inst ... PCP 1.3
  256.            # inst ... PCPWEB 1.1
  257.  
  258.        Installation of _p_c_p._s_w._c_o_l_l_e_c_t_o_r requires the prior
  259.        installation the _l_i_b_i_r_i_x_p_m_d_a._s_o library to export
  260.        performance metrics from IRIX.
  261.  
  262.        For IRIX 5.3, _l_i_b_i_r_i_x_p_m_d_a._s_o should be installed from the
  263.        _e_o_e_2._s_w._p_e_r_f subsystem.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.                                   - 5 -
  277.  
  278.  
  279.  
  280.        For IRIX 6.2 or later, _l_i_b_i_r_i_x_p_m_d_a._s_o should be installed
  281.        from the _e_o_e._s_w._p_e_r_f subsystem.
  282.  
  283.        Subsequent to IRIX releases, patches are used to maintain
  284.        _l_i_b_i_r_i_x_p_m_d_a._s_o compatibility for IRIX changes.  The relevant
  285.        patches at the time of the PCP 1.3 release are as follows.
  286.  
  287.                    ____________________________________
  288.                      IRIX
  289.                     Version   Patch for _l_i_b_i_r_i_x_p_m_d_a._s_o
  290.                    ____________________________________
  291.                       5.2               1299
  292.                       6.2               1911
  293.                       6.3               1912
  294.                       6.4               1914
  295.                    ____________________________________
  296.                    |||||||
  297.  
  298.  
  299.  
  300.  
  301.  
  302.                             |||||||
  303.  
  304.  
  305.  
  306.  
  307.  
  308.                                                        |||||||
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.        The _p_c_p._s_w._m_o_n_i_t_o_r utilities requires dynamic shared
  317.        libraries from the subsystems: _m_o_t_i_f__e_o_e._s_w._e_o_e,
  318.        _x__e_o_e._s_w._e_o_e, _c_o_m_p_i_l_e_r__e_o_e._s_w._l_i_b and
  319.        _i_n_v_e_n_t_o_r__e_o_e._s_w._i_n_v_e_n_t_o_r (version 2.1 or later).
  320.  
  321.        _p_c_p._s_w._d_e_m_o contains C source files that need to be
  322.        compiled.  To compile these example programs prior
  323.        installation of the following subsystems is required:
  324.        _d_e_v._h_d_r._l_i_b, _d_e_v._s_w._l_i_b, _c__d_e_v._s_w._c, _c_o_m_p_i_l_e_r__d_e_v._h_d_r._l_i_b,
  325.        _c_o_m_p_i_l_e_r__d_e_v._s_w._b_a_s_e, _c_o_m_p_i_l_e_r__d_e_v._s_w._l_d and
  326.        _c_o_m_p_i_l_e_r__d_e_v._s_w._l_i_b.  However, as the _p_c_p._s_w._d_e_m_o subsystem
  327.        includes a number of other examples that do not require
  328.        compilation, these prerequisites are not mandated in the PCP
  329.        images.
  330.  
  331.        If the Performance Metrics Collector Daemon (PMCD) is
  332.        already running on the system to which the new installation
  333.        is going to be applied, then you must terminate ppppmmmmccccdddd before
  334.        starting the installation.  Similarly, any instance of the
  335.        ppppmmmmllllooooggggggggeeeerrrr utility should be terminated.  For example, use the
  336.        following commands as rrrrooooooootttt:
  337.  
  338.            # /etc/init.d/pcp stop
  339.            # killall -INT pmlogger
  340.  
  341.        This is necessary because the subsystems to be installed
  342.        include new versions of shared libraries (DSOs) that may be
  343.        used by these PCP utilities.
  344.  
  345.        The collector and monitor functionality of the PCP product
  346.        require the installation of separate collector and monitor
  347.        software licenses to operate, and installation of the
  348.        software will be expedited if the license(s) are installed
  349.        before the PCP installation commences.  Refer to chapter 7
  350.        of these release notes for the license installation
  351.        procedure.
  352.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.                                   - 6 -
  363.  
  364.  
  365.  
  366.        2.5  _P_o_s_t_-_I_n_s_t_a_l_l_a_t_i_o_n__P_r_o_c_e_d_u_r_e_s
  367.  
  368.        If ppppmmmmccccdddd is to be started (i.e. this system is to be a
  369.        collector) use the commands:
  370.  
  371.            # chkconfig pmcd on
  372.            # chkconfig pmlogger on
  373.            # /etc/init.d/pcp start
  374.  
  375.        Note that ``chkconfig pmlogger on'' is only required if you
  376.        wish to launch the primary ppppmmmmllllooooggggggggeeeerrrr instance in conjunction
  377.        with ppppmmmmccccdddd - refer to the ppppmmmmllllooooggggggggeeeerrrr(1) man page for more
  378.        details.
  379.  
  380.        2.6  _C_o_m_p_a_t_i_b_i_l_i_t_y
  381.  
  382.        PCP 1.3 involves some evolutionary changes that may effect
  383.        PCP add-on products.  The following points highlight these
  384.        dependencies and suggest workarounds for minor
  385.        incompatibility issues.
  386.  
  387.          1.  The PMDA _I_n_s_t_a_l_l and _R_e_m_o_v_e scripts for the SC4-
  388.              PCPSYB10 product, assume the PMDA log files will be
  389.              created in /_v_a_r/_t_m_p, however for PCP 1.3 these files
  390.              will be created in /_v_a_r/_a_d_m/_p_c_p_l_o_g by default.  When
  391.              running the PMDA _I_n_s_t_a_l_l or _R_e_m_o_v_e scripts for ssssyyyybbbb11110000
  392.              or ssssyyyybbbbppppiiiinnnngggg PMDAs, use the following steps:
  393.  
  394.                 +o Login as rrrrooooooootttt.
  395.  
  396.                 +o /etc/init.d/pcp stop
  397.  
  398.                 +o PCP_LOGDIR=/var/tmp; export PCP_LOGDIR
  399.                   (or setenv PCP_LOGDIR /var/tmp)
  400.  
  401.                 +o Install or Remove, as per the instructions for
  402.                   the PMDA.
  403.  
  404.                 +o unset PCP_LOGDIR
  405.                   (or unsetenv PCP_LOGDIR)
  406.  
  407.                 +o /etc/init.d/pcp start
  408.  
  409.        2.7  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  410.  
  411.        The post-installation and PCP customization tasks are fully
  412.        described in the _P_e_r_f_o_r_m_a_n_c_e _C_o-_P_i_l_o_t _U_s_e_r'_s _a_n_d
  413.        _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e Insight book.  The notes in this
  414.        section serve as a summary.
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.                                   - 7 -
  429.  
  430.  
  431.  
  432.        You may need to edit some configuration files to complete
  433.        the PCP installation, configuration and customization.  If
  434.        you are reinstalling PCP or upgrading an earlier PCP
  435.        installation, any existing configuration will be retained,
  436.        and any new default configuration files will be installed
  437.        with a ....NNNN file suffix.
  438.  
  439.           +o /_e_t_c/_p_m_c_d._c_o_n_f - this file specifies which Performance
  440.             Metrics Domain Agents (PMDAs) shall be available.
  441.             Refer to the ppppmmmmccccdddd(1) man page for further details.
  442.  
  443.             If you are upgrading a Performance Co-Pilot
  444.             installation, you may need to re-install any optional
  445.             PMDAs.  The procedure for doing this is covered in the
  446.             last section of this chapter.
  447.  
  448.             Pay particular attention to the format of the last
  449.             field for the entries for the common PMDAs (iiiirrrriiiixxxx, ppppmmmmccccdddd
  450.             and pppprrrroooocccc), as the detailed syntax has changed with
  451.             respect to some earlier PCP releases (specifically
  452.             there should be no absolute pathnames for these three
  453.             PMDAs).  These entries should be as follows:
  454.  
  455.                 irix  1       dso     irix_init       libirixpmda.so
  456.                 pmcd  2       dso     pmcd_init       pmda_pmcd.so
  457.                 proc  3       dso     proc_init       pmda_proc.so
  458.  
  459.           +o /_e_t_c/_c_o_n_f_i_g/_p_m_c_d - this file controls whether the
  460.             Performance Metrics Collector Daemon (PMCD) is run as
  461.             part of the system boot procedure.  Refer to the
  462.             ppppmmmmccccdddd(1) man page for further details.
  463.  
  464.           +o /_e_t_c/_c_o_n_f_i_g/_p_m_c_d._o_p_t_i_o_n_s - command-line options for the
  465.             automatic startup of the PMCD.  Refer to the ppppmmmmccccdddd(1)
  466.             man page for further details.
  467.  
  468.           +o /_e_t_c/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r - this file controls whether the
  469.             primary instance of ppppmmmmllllooooggggggggeeeerrrr is run as part of the
  470.             system boot procedure.  Refer to the ppppmmmmllllooooggggggggeeeerrrr(1) man
  471.             page for further details.
  472.  
  473.           +o /_e_t_c/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r._o_p_t_i_o_n_s - command-line options for
  474.             the automatic startup of the primary ppppmmmmllllooooggggggggeeeerrrr instance.
  475.             Refer to the ppppmmmmllllooooggggggggeeeerrrr(1) man page for further details.
  476.  
  477.           +o /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._d_e_f_a_u_l_t - this file
  478.             specifies the performance metrics to be logged and
  479.             frequency of logging by the primary logger.  Refer to
  480.             the ppppmmmmllllooooggggggggeeeerrrr(1) man page for further details.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.                                   - 8 -
  495.  
  496.  
  497.  
  498.             If you are upgrading a Performance Co-Pilot 1.0
  499.             installation, and you wish to retain the existing
  500.             configuration file /_u_s_r/_l_i_b/_p_c_p/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r._c_o_n_f_i_g
  501.             for the primary logger, you should do the following as
  502.             rrrrooooooootttt:
  503.  
  504.                 # cd /usr/lib/pcp/config
  505.                 # mv pmlogger.config /var/pcp/config/pmlogger/config.default
  506.  
  507.             If you are upgrading a Performance Co-Pilot 1.1
  508.             installation, and you wish to retain the existing
  509.             configuration file /_u_s_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r._c_o_n_f_i_g for
  510.             the primary logger, you should do the following as
  511.             rrrrooooooootttt:
  512.  
  513.                 # cd /usr/pcp/config
  514.                 # mv pmlogger.config /var/pcp/config/pmlogger/config.default
  515.  
  516.             Otherwise you may wish to remove the old
  517.             /_u_s_r/_l_i_b/_p_c_p/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r._c_o_n_f_i_g and/or
  518.             /_u_s_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r._c_o_n_f_i_g files.
  519.  
  520.           +o /_v_a_r/_p_c_p/_p_m_n_s - this directory contains both a machine
  521.             friendly (/_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t._b_i_n) and human readable
  522.             format (all other files) of the default Performance
  523.             Metrics Name Space (PMNS).  Refer to the ppppmmmmnnnnssss(4) and
  524.             ppppmmmmnnnnssssccccoooommmmpppp(1) man pages for further details.
  525.  
  526.             If you are upgrading a Performance Co-Pilot 1.0
  527.             installation, it is recommended that you remove the old
  528.             directory /_u_s_r/_l_i_b/_p_c_p/_p_m_n_s entirely, and re-install
  529.             the PMNS for any optional PMDAs.
  530.  
  531.             If you are upgrading a Performance Co-Pilot 1.1
  532.             installation, the existing PMNS in /_u_s_r/_p_c_p/_p_m_n_s will
  533.             be automatically relocated to /_v_a_r/_p_c_p/_p_m_n_s.  In the
  534.             unlikely event that this fails, you will need to re-
  535.             install the PMNS for any optional PMDAs.
  536.  
  537.             If you are upgrading a Performance Co-Pilot
  538.             installation, there may be some changes in the PMNS
  539.             that have to be reconciled.  If you end up with both of
  540.             the files /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t and /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t._N,
  541.             then the differences between the two files should be
  542.             disjoint, resulting from
  543.  
  544.               a.  changes to the base PMNS - these will likely be
  545.                   additions to _r_o_o_t._N that are not in _r_o_o_t, and
  546.  
  547.               b.  additions to _r_o_o_t due to the local configuration
  548.                   of PMDAs.
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.                                   - 9 -
  561.  
  562.  
  563.  
  564.             To update (or reconstruct) the PMNS, execute the
  565.             following commands as rrrrooooooootttt:
  566.                 # cd /var/pcp/pmns
  567.                 # : merge anything new from root.N into root
  568.                 # : ditto for any other .N files
  569.                 # ./Rebuild
  570.                 # rm -f root.N
  571.  
  572.        2.8  _F_i_l_e_s__N_o_t__L_i_s_t_e_d__b_y__vvvv_eeee_rrrr_ssss_iiii_oooo_nnnn_ssss
  573.  
  574.        If any of the optional Performance Metric Domain Agents
  575.        (PMDAs) have been activated (i.e. installed from
  576.        /_u_s_r/_p_c_p/_p_m_d_a_s) or customized PMDAs have been developed and
  577.        installed, then files may have been added and/or modified in
  578.        the following places.
  579.  
  580.           +o /_u_s_r/_p_c_p/_p_m_d_a_s - optional PMDAs are located in
  581.             directories below here; the _I_n_s_t_a_l_l scripts may create
  582.             executable binaries and/or help text files in these
  583.             directories.
  584.  
  585.           +o /_v_a_r/_p_c_p/_l_i_b - files named _p_m_d_a_*._s_o are the access
  586.             methods or daemons that implement the PMDA
  587.             functionality within the Performance Metrics Collection
  588.             System (PMCS).  Some of these may have been installed
  589.             by the PMDA _I_n_s_t_a_l_l scripts after the PCP images were
  590.             installed with iiiinnnnsssstttt(1).
  591.  
  592.           +o /_v_a_r/_p_c_p/_p_m_n_s - any expansion of the Performance
  593.             Metrics Name Space (PMNS) may cause new files to be
  594.             added into this directory.
  595.  
  596.           +o /_v_a_r/_p_c_p/_c_o_n_f_i_g - assorted PMDAs and optionally
  597.             configured PCP services are inclined to have
  598.             configuration files below this directory that may be
  599.             added or modified as part of their site-specific
  600.             configuration after installation.
  601.  
  602.           +o /_v_a_r/_a_d_m/_p_c_p_l_o_g - the diagnostic logs from ppppmmmmccccdddd and
  603.             PMDAs for a PCP collector configuration reside here.
  604.             If ppppmmmmllllooooggggggggeeeerrrr instances are activated, it is most likely
  605.             that the PCP archive log files will be created below
  606.             here - one directory per logged host.
  607.  
  608.        2.9  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  609.  
  610.        After installation has completed you should run the command
  611.  
  612.            showfiles -c -C -H pcp
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.                                   - 10 -
  627.  
  628.  
  629.  
  630.        This will list files that have been customized for your site
  631.        that iiiinnnnsssstttt had a replacement for.  Existing files moved aside
  632.        will have a ....OOOO extension and new files that iiiinnnnsssstttt did not
  633.        substitute for existing ones will have a ....NNNN extension.  You
  634.        must reconcile any differences between the files by hand.
  635.  
  636.        Several optional and example Performance Metric Domain
  637.        Agents (PMDAs) are also shipped with the Performance Co-
  638.        Pilot.  These provide additional performance metrics and
  639.        examples of PMDAs.
  640.  
  641.        The example and optional PMDAs and their associated source,
  642.        configuration and executable files are located in
  643.        subdirectories below /_u_s_r/_p_c_p/_p_m_d_a_s.  In each directory you
  644.        will find the following files.
  645.  
  646.        _R_E_A_D_M_E    An overview of this PMDA, with particular
  647.                  reference to the range of performance metrics it
  648.                  supports, and any special installation directions.
  649.  
  650.        _I_n_s_t_a_l_l   A ////bbbbiiiinnnn////sssshhhh script to install the PMDA and/or the
  651.                  associated PMNS components.  The tasks performed
  652.                  by this script are fully described in the
  653.                  _P_e_r_f_o_r_m_a_n_c_e _C_o-_P_i_l_o_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e Insight
  654.                  book.
  655.  
  656.        _R_e_m_o_v_e    A ////bbbbiiiinnnn////sssshhhh script to reverse the tasks performed by
  657.                  _I_n_s_t_a_l_l.  The tasks performed by this script are
  658.                  fully described in the _P_e_r_f_o_r_m_a_n_c_e _C_o-_P_i_l_o_t
  659.                  _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e Insight book.
  660.  
  661.        other     Assorted configuration files, C or C++ source,
  662.                  relocatable binaries, help text.
  663.  
  664.        Both _I_n_s_t_a_l_l and _R_e_m_o_v_e modify the contents of protected
  665.        files and directories, and hence must be run as rrrrooooooootttt.
  666.  
  667.        The basic procedure you need to follow to configure an
  668.        optional PMDA is set out below.  You should, however, check
  669.        the relevant _R_E_A_D_M_E file for any additional steps that may
  670.        be required.
  671.  
  672.        PCP ccccoooolllllllleeeeccccttttoooorrrr systems
  673.                For each system on which the optional metrics are to
  674.                be collected do the following as rrrrooooooootttt:
  675.  
  676.                    # cd /usr/pcp/pmdas/_P_M_D_A-_n_a_m_e
  677.                    # ./Install
  678.  
  679.        PCP mmmmoooonnnniiiittttoooorrrr systems
  680.                For each system on which optional metrics are to be
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.                                   - 11 -
  693.  
  694.  
  695.  
  696.                monitored do the following as rrrrooooooootttt:
  697.  
  698.                    # cd /usr/pcp/pmdas/_P_M_D_A-_n_a_m_e
  699.                    # ./Install -N
  700.  
  701.        Finally, there is a Showcase tutorial introduction to the
  702.        Performance Co-Pilot, distributed in the _p_c_p._m_a_n._t_u_t_o_r_i_a_l
  703.        subsystem.  See the _R_E_A_D_M_E file in the directory
  704.        /_v_a_r/_p_c_p/_d_e_m_o_s/_T_u_t_o_r_i_a_l for instructions.
  705.  
  706.        2.10  _T_r_a_c_k_i_n_g__I_R_I_X__U_p_g_r_a_d_e_s
  707.  
  708.        PCP has dependencies on IRIX as follows:
  709.  
  710.           +o For PCP ccccoooolllllllleeeeccccttttoooorrrr systems, the the PCP methods
  711.             libraries for IRIX performance metrics
  712.             (/_u_s_r/_p_c_p/_l_i_b/_m_i_p_s_*._l_i_b_i_r_i_x_p_m_d_a._s_o) must be
  713.             installed/upgraded from the _e_o_e_2._s_w._p_e_r_f subsystem (for
  714.             IRIX 5.3) or the _e_o_e._s_w._p_e_r_f subsystem (for all other
  715.             IRIX versions supported by PCP).  Refer also to the
  716.             table of associated IRIX patches in section 2.4 above.
  717.  
  718.             These changes should occur smoothly at each IRIX
  719.             upgrade or patch installation, and will be evident the
  720.             next time ppppmmmmccccdddd(1) is re-started.
  721.  
  722.           +o For PCP mmmmoooonnnniiiittttoooorrrr systems, the names of the IRIX
  723.             performance metrics from each PCP collector system to
  724.             be monitored have to be merged into the local PMNS.
  725.  
  726.             As these changes may occur remotely from the PCP
  727.             mmmmoooonnnniiiittttoooorrrr system, some manual intervention may be
  728.             required, as described below.
  729.  
  730.        To upgrade the local PMNS:
  731.  
  732.          1.  Choose the PCP ccccoooolllllllleeeeccccttttoooorrrr system with the most recent
  733.              IRIX version at or after IRIX 6.4.
  734.  
  735.          2.  Copy the files /_v_a_r/_p_c_p/_p_m_n_s/_i_r_i_x-_p_m_n_s and
  736.              /_v_a_r/_p_c_p/_p_m_n_s/_i_r_i_x-_n_a_m_e_s from that system to the local
  737.              system.
  738.  
  739.          3.  Execute the following commands as rrrrooooooootttt on the local
  740.              system:
  741.                  # cd /var/pcp/pmns
  742.                  # ./Rebuild
  743.  
  744.              The should produce output similar to:
  745.                  Rebuilding the Performance Metrics Name Space (PMNS) in /usr/var/pcp/pmns ...
  746.                  Rebuild: merging the following PMNS files:
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                                   - 12 -
  759.  
  760.  
  761.  
  762.                      root root_hpux root_irix root_pcp root_pmcd root_proc
  763.                  Rebuild: Old root of PMNS preserved in "root.save"
  764.                  Compiled PMNS (/var/pcp/pmns/root.bin) updated
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.